home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_python.idb / usr / freeware / catman / u_man / cat1 / python.Z / python
Encoding:
Text File  |  1999-04-16  |  12.2 KB  |  331 lines
  1.  
  2.  
  3.  
  4.      PPPPYYYYTTTTHHHHOOOONNNN((((11110000 AAAApppprrrriiiillll,,,, 1111999999998888))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    PPPPYYYYTTTTHHHHOOOONNNN((((11110000 AAAApppprrrriiiillll,,,, 1111999999998888))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       python - an interpreted, interactive,    object-oriented
  10.       programming language
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       ppppyyyytttthhhhoooonnnn [ ----dddd ]    [ ----iiii ] [ ----OOOO ] [    ----SSSS ] [ ----tttt ] [ ----uuuu ] [ ----vvvv    ] [ ----xxxx
  14.       ] [ ----XXXX ]
  15.          [ ----cccc _c_o_m_m_a_n_d |    _s_c_r_i_p_t | - ] [ _a_r_g_u_m_e_n_t_s ]
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.       Python is an interpreted, interactive, object-oriented
  19.       programming language that combines remarkable    power with
  20.       very clear syntax.  For an introduction to programming in
  21.       Python you are referred to the Python    Tutorial.  The Python
  22.       Library Reference documents built-in and standard types,
  23.       constants, functions and modules.  Finally, the Python
  24.       Reference Manual describes the syntax    and semantics of the
  25.       core language    in (perhaps too) much detail.
  26.  
  27.       Python's basic power can be extended with your own modules
  28.       written in C or C++.    On most    systems    such modules may be
  29.       dynamically loaded.  Python is also adaptable    as an
  30.       extension language for existing applications.     See the
  31.       internal documentation for hints.
  32.  
  33.      CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS
  34.       ----dddd   Turn on parser debugging    output (for wizards only,
  35.            depending on compilation    options).
  36.  
  37.       ----iiii   When a script is    passed as first    argument or the    ----cccc
  38.            option is used, enter interactive mode after executing
  39.            the script or the command.  It does not read the
  40.            $PYTHONSTARTUP file.  This can be useful    to inspect
  41.            global variables    or a stack trace when a    script raises
  42.            an exception.
  43.  
  44.       ----OOOO   Turn on basic optimizations.  This changes the filename
  45.            extension for compiled (bytecode) files from ._p_y_c to
  46.            _p_y_o.
  47.  
  48.       ----SSSS   Disable the import of the module    _s_i_t_e and the site-
  49.            dependent manipulations of _s_y_s._p_a_t_h that    it entails.
  50.  
  51.       ----tttt   Issue a warning when a source file mixes    tabs and
  52.            spaces for indentation in a way that makes it depend on
  53.            the worth of a tab expressed in spaces.    Issue an error
  54.            when the    option is given    twice.
  55.  
  56.       ----uuuu   Force stdin, stdout and stderr to be totally
  57.            unbuffered.
  58.  
  59.       ----vvvv   Print a message each time a module is initialized,
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 3/30/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      PPPPYYYYTTTTHHHHOOOONNNN((((11110000 AAAApppprrrriiiillll,,,, 1111999999998888))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    PPPPYYYYTTTTHHHHOOOONNNN((((11110000 AAAApppprrrriiiillll,,,, 1111999999998888))))
  71.  
  72.  
  73.  
  74.            showing the place (filename or built-in module) from
  75.            which it    is loaded.
  76.  
  77.       ----xxxx   Skip the    first line of the source.  This    is intended
  78.            for a DOS specific hack only.  Warning: the line
  79.            numbers in error    messages will be off by    one!
  80.  
  81.       ----XXXX   Make the    standard exceptions strings instead of
  82.            classes.     Use for backward compatibility    with old code
  83.            only.
  84.  
  85.       ----cccc _c_o_m_m_a_n_d
  86.            Specify the command to execute (see next    section).
  87.            This terminates the option list (following options are
  88.            passed as arguments to the command).
  89.  
  90.      IIIINNNNTTTTEEEERRRRPPPPRRRREEEETTTTEEEERRRR IIIINNNNTTTTEEEERRRRFFFFAAAACCCCEEEE
  91.       The interpreter interface resembles that of the UNIX shell:
  92.       when called with standard input connected to a tty device,
  93.       it prompts for commands and executes them until an EOF is
  94.       read;    when called with a file    name argument or with a    file
  95.       as standard input, it    reads and executes a _s_c_r_i_p_t from that
  96.       file;    when called with ----cccc _c_o_m_m_a_n_d, it    executes the Python
  97.       statement(s) given as    _c_o_m_m_a_n_d. Here _c_o_m_m_a_n_d may contain
  98.       multiple statements separated    by newlines.  Leading
  99.       whitespace is    significant in Python statements!  In non-
  100.       interactive mode, the    entire input is    parsed befored it is
  101.       executed.
  102.  
  103.       If available,    the script name    and additional arguments
  104.       thereafter are passed    to the script in the Python variable
  105.       _s_y_s._a_r_g_v , which is a    list of    strings    (you must first    _i_m_p_o_r_t
  106.       _s_y_s to be able to access it).     If no script name is given,
  107.       _s_y_s._a_r_g_v is empty; if    ----cccc is used, _s_y_s._a_r_g_v[_0]    contains the
  108.       string '-_c'. Note that options interpreted by    the Python
  109.       interpreter itself are not placed in _s_y_s._a_r_g_v.
  110.  
  111.       In interactive mode, the primary prompt is `>>>'; the    second
  112.       prompt (which    appears    when a command is not complete)    is
  113.       `...'.  The prompts can be changed by    assignment to _s_y_s._p_s_1
  114.       or _s_y_s._p_s_2. The interpreter quits when it reads an EOF at a
  115.       prompt.  When    an unhandled exception occurs, a stack trace
  116.       is printed and control returns to the    primary    prompt;    in
  117.       non-interactive mode,    the interpreter    exits after printing
  118.       the stack trace.  The    interrupt signal raises    the _K_e_y_b_o_a_r_d_-
  119.       _I_n_t_e_r_r_u_p_t exception; other UNIX signals are not caught
  120.       (except that SIGPIPE is sometimes ignored, in    favor of the
  121.       _I_O_E_r_r_o_r exception).  Error messages are written to stderr.
  122.  
  123.      FFFFIIIILLLLEEEESSSS AAAANNNNDDDD DDDDIIIIRRRREEEECCCCTTTTOOOORRRRIIIIEEEESSSS
  124.       These    are subject to difference depending on local
  125.       installation conventions:
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 3/30/99)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      PPPPYYYYTTTTHHHHOOOONNNN((((11110000 AAAApppprrrriiiillll,,,, 1111999999998888))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    PPPPYYYYTTTTHHHHOOOONNNN((((11110000 AAAApppprrrriiiillll,,,, 1111999999998888))))
  137.  
  138.  
  139.  
  140.       /usr/local/bin/python
  141.            Recommended location of the interpreter.
  142.  
  143.       /usr/local/lib/python<version>
  144.            Recommended location of the directory containing    the
  145.            standard    modules.
  146.  
  147.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
  148.       PYTHONHOME
  149.            Change the location of the standard Python libraries.
  150.            By default, the libraries are searched in
  151.            <prefix>/lib/python<version> and
  152.            <exec_prefix>/lib/python<version>, where    <prefix> and
  153.            <exec_prefix> are installation-dependent    directories,
  154.            both defaulting to /usr/local.  When $PYTHONHOME    is set
  155.            to a single directory, its value    replaces both <prefix>
  156.            and <exec_prefix>.  To specify different    values for
  157.            these, set $PYTHONHOME to <prefix>:<exec_prefix>.
  158.  
  159.       PYTHONPATH
  160.            Augments    the default search path    for module files.  The
  161.            format is the same as the shell's $PATH:    one or more
  162.            directory pathnames separated by    colons.     Non-existant
  163.            directories are silently    ignored.  The default search
  164.            path is installation dependent, but generally begins
  165.            with <prefix>/lib/python<version> (see PYTHONHOME
  166.            below).    The default search path    is always appended to
  167.            $PYTHONPATH.  If    a script argument is given, the
  168.            directory containing the    script is inserted in the path
  169.            in front    of $PYTHONPATH.     The search path can be
  170.            manipulated from    within a Python    program    as the
  171.            variable    _s_y_s._p_a_t_h .
  172.  
  173.       PYTHONSTARTUP
  174.            If this is the name of a    readable file, the Python
  175.            commands    in that    file are executed before the first
  176.            prompt is displayed in interactive mode.     The file is
  177.            executed    in the same name space where interactive
  178.            commands    are executed so    that objects defined or
  179.            imported    in it can be used without qualification    in the
  180.            interactive session.  You can also change the prompts
  181.            _s_y_s._p_s_1 and _s_y_s._p_s_2 in this file.
  182.  
  183.       PYTHONDEBUG
  184.            If this is set to a non-empty string it is equivalent
  185.            to specifying the ----dddd option.
  186.  
  187.       PYTHONINSPECT
  188.            If this is set to a non-empty string it is equivalent
  189.            to specifying the ----iiii option.
  190.  
  191.       PYTHONUNBUFFERED
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 3/30/99)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      PPPPYYYYTTTTHHHHOOOONNNN((((11110000 AAAApppprrrriiiillll,,,, 1111999999998888))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    PPPPYYYYTTTTHHHHOOOONNNN((((11110000 AAAApppprrrriiiillll,,,, 1111999999998888))))
  203.  
  204.  
  205.  
  206.            If this is set to a non-empty string it is equivalent
  207.            to specifying the ----uuuu option.
  208.  
  209.       PYTHONVERBOSE
  210.            If this is set to a non-empty string it is equivalent
  211.            to specifying the ----vvvv option.
  212.  
  213.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  214.       Python Tutorial
  215.       Python Library Reference
  216.       Python Reference Manual
  217.  
  218.      AAAAUUUUTTTTHHHHOOOORRRR
  219.       Guido    van Rossum
  220.       CNRI
  221.       1895 Preston White Drive
  222.       Reston, VA 20191
  223.       USA
  224.  
  225.       E-mail: guido@cnri.reston.va.us, guido@python.org
  226.  
  227.       And a    cast of    thousands.
  228.  
  229.      IIIINNNNTTTTEEEERRRRNNNNEEEETTTT RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  230.       Web site: http://www.python.org
  231.       FTP site: ftp://ftp.python.org
  232.       Newsgroup: comp.lang.python
  233.  
  234.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  235.       Copyright 1991-1995 by Stichting Mathematisch    Centrum,
  236.       Amsterdam, The Netherlands.
  237.  
  238.            All Rights Reserved
  239.  
  240.       Permission to    use, copy, modify, and distribute this
  241.       software and its documentation for any purpose and without
  242.       fee is hereby    granted, provided that the above copyright
  243.       notice appear    in all copies and that both that copyright
  244.       notice and this permission notice appear in supporting
  245.       documentation, and that the names of Stichting Mathematisch
  246.       Centrum or CWI or Corporation    for National Research
  247.       Initiatives or CNRI not be used in advertising or publicity
  248.       pertaining to    distribution of    the software without specific,
  249.       written prior    permission.
  250.  
  251.       While    CWI is the initial source for this software, a
  252.       modified version is made available by    the Corporation    for
  253.       National Research Initiatives    (CNRI) at the Internet address
  254.       ftp://ftp.python.org.
  255.  
  256.       STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL
  257.       WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 3/30/99)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      PPPPYYYYTTTTHHHHOOOONNNN((((11110000 AAAApppprrrriiiillll,,,, 1111999999998888))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    PPPPYYYYTTTTHHHHOOOONNNN((((11110000 AAAApppprrrriiiillll,,,, 1111999999998888))))
  269.  
  270.  
  271.  
  272.       IMPLIED WARRANTIES OF    MERCHANTABILITY    AND FITNESS, IN    NO
  273.       EVENT    SHALL STICHTING    MATHEMATISCH CENTRUM OR    CNRI BE    LIABLE
  274.       FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR    ANY
  275.       DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
  276.       PROFITS, WHETHER IN AN ACTION    OF CONTRACT, NEGLIGENCE    OR
  277.       OTHER    TORTIOUS ACTION, ARISING OUT OF    OR IN CONNECTION WITH
  278.       THE USE OR PERFORMANCE OF THIS SOFTWARE.
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 3/30/99)
  328.  
  329.  
  330.  
  331.